home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 033a / topdown.zip / TOPDOWN.DOC < prev    next >
Text File  |  1991-10-15  |  5KB  |  111 lines
  1. TOPDOWN.EXE                     Karl Schneider
  2.                                 S & H Engineering, Inc.
  3. For WILDCAT 3.0x+ ONLY          8505 Woodwick Ct.
  4.                                 Tampa, FL 33615
  5.                                 813 884 9661 voice
  6.                                 My BBS is temporarily down......
  7.  
  8.  
  9. TOPDOWN is a Wildcat 3.0x+ utility which makes an ascii list of the
  10. top 10 or more or less most downloaded files from the Wildcat board.
  11. This list is suitable for a bulletin, hellox file, etc.  It sets up
  12. and runs almost identically to my files listing program WC3FLIST.
  13.  
  14. You may include or omit 'passworded' files, exclude one or more
  15. file AREAS from the list or INCLUDE ONLY one or more areas, and have a
  16. detailed listing showing filename, date, size, # of downloads, and
  17. description, or a 'short' version showing only filename, K size and
  18. description.  TOPDOWN produces lists similar to those made by FLOP
  19. (c) Michael Conley, but should be substantially faster, as it is com-
  20. piled in TurboC and does not require BRUN runtime modules.
  21.  
  22. Usage:  TOPDOWN 15
  23.  
  24.         lists the 15 most downloaded files in the specified output file.
  25.  
  26. TOPDOWN.EXE can live anywhere in your PATH...but it must be EXECUTED from
  27. your Wildcat Home Node Directory(s).  (Any node is OK....full file
  28. sharing is supported and nodes do not need to be 'down')
  29.  
  30. In the same Home Node Directory for whatever node you're running TOPDOWN
  31. on, you must have a text file, TOPDOWN.CFG.  A sample copy is included
  32. in this archive and is reproduced here.  Edit this with any text ed-
  33. itor to fit your requirements.
  34.  
  35. >> When editing TOPDOWN.CFG, be sure your editor doesn't add extra
  36. >> lines or characters at the end of the file.  I had one report that
  37. >> the XTREE editor adds 2 blank lines and some kind of strange eof
  38. >> marker.  If you get a "ERROR in TOPDOWN.CFG" message, check it for
  39. >> something like this.  As a last resort, EDLIN (I know, I know)
  40. >> works fine, and it's not that big a file! <g>
  41.  
  42. @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
  43. @ Here's a sample TOPDOWN.CFG file.  Any lines beginning with a @
  44. @ are ignored.  You can delete any of them, or leave them for reference.
  45. @ Lines NOT starting with @ are parameter lines. There must be SIX of
  46. @ them as shown below.  Change the information AFTER
  47. @ the : (colon) in them as desired.  Do NOT change the ORDER of the lines,
  48. @ do NOT leave out the colon and do NOT leave any spaces
  49. @ between the colon and your option(s)!  (colons in a filepath as
  50. @ below are OK, the program is only interested iin the FIRST one in
  51. @ a line).
  52. @
  53. @ The short (single line) listing shows only filename, K size and
  54. @ description.  If this is picked (Y), no passwords will be either
  55. @ shown or masked!
  56. @
  57. @ The Include ONLY and EXCLUDE options are mutually exclusive; that is,
  58. @ You cannot Include ONLY some areas and then EXCLUDE some, and vice-
  59. @ versa. Line length is limited to 250 characters, and number of
  60. @ either Includes or Excludes up to 100.  Separate them with commas
  61. @ as shown below.
  62. @
  63. @ To include ALL file areas, don't add anything to the Include or EXCLUDE
  64. @ lines.  See TOPDOWN.DOC for more information.
  65. @
  66. @ Options on the 'Include passworded files' are as follows:
  67. @ Y -- includes passworded files but masks out the p/w with *********.
  68. @ N -- omits all passworded files from the list.
  69. @ O -- includes ONLY passworded files (from non-excluded areas) and
  70. @      SHOWS the password
  71. @ S -- includes ALL files including those with passwords (from non-
  72. @      excluded areas and SHOWS their passwords.
  73. BBS Name:Agora BBS of Tampa
  74. Include passworded files?:y
  75. Short (single line) listing?:n
  76. Include ONLY areas:
  77. EXCLUDE areas:2,19,83
  78. Output file pathname:D:\WC30\BULLETIN\BULL0003.BBS
  79. @ This line will be ingored too and can be deleted.
  80. @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
  81.  
  82. Note that only lines NOT starting with '@' are actually used by the
  83. program.  You may delete any or all lines beginning with the '@' symbol.
  84. Follow the instructions above.  You can, of course run TOPDOWN in a
  85. batch file and by copying different configurations into TOPDOWN.CFG,
  86. create several different reports for different conferences, etc, like
  87. this:
  88.  
  89. copy config1 topdown.cfg
  90. topdown
  91. copy config2 topdown.cfg
  92. topdown
  93. copy config3 topdown.cfg
  94. topdown
  95. ....etc...
  96.  
  97. This programs uses memory up to the available limit. It should handle
  98. about 8500 files, depending on your memory and setup.  If you find it
  99. running out of memory (it will tell you!)....you will probably need to
  100. run it more than once, with different groups of 'included areas'.  You
  101. can than of course copy the output files together with DOS COPY...
  102.  
  103. Please consider registering this program if you find it useful.
  104. A lot of time and effort has gone into creating the WILDCAT utilities
  105. I've written.  I find them useful, and hope you do too!  $10 or
  106. $15 or so would be reasonable.  If you register this program, you will get
  107. full support via the numbers above and enhancements or customiz-
  108. ation within reason.  Thanks!
  109.  
  110. -end of file-
  111.